home *** CD-ROM | disk | FTP | other *** search
/ Aminet 24 / Aminet 24 (1998)(GTI - Schatztruhe)[!][Apr 1998].iso / Aminet / util / arc / PPCTarWOS.lha / DeTar.doc next >
Text File  |  1998-02-18  |  9KB  |  248 lines
  1.  
  2.  
  3.                                 DeTar V1.3
  4.  
  5.                               - PUBLIC DOMAIN -
  6.  
  7.           rewritten in 1998 by Steffen P. Haeuser.
  8.           ported and re-written in 1994-97 by Andreas R. Kleinert.
  9.           based on code for MS-DOS written in 1988 by Steve R. Sampson
  10.  
  11.           This program was written under OS V3.1 and is therefore
  12.           fully compatible. It needs OS V1.2+.
  13.  
  14.           Release Date : 27.10.1997
  15.  
  16.  
  17.     Copyright :
  18.     ===========
  19.     The program DeTar and its documentation files are placed in the
  20.     PUBLIC DOMAIN.
  21.  
  22.  
  23.     Disclaimer :
  24.     ============
  25.     The author takes no responsibility for any results of the use of this
  26.     program.
  27.     This software is provided "AS IS" and there is no warranty of any kind,
  28.     so that you use this software at your own risk.
  29.  
  30.  
  31.     Distribution :
  32.     ==============
  33.     The program Detar is freely distributable (PUBLIC DOMAIN).
  34.     You may copy it, if all of its parts are included in the distribution.
  35.  
  36.     This program may be put on public domain disks or included in public
  37.     domain disk libraries.
  38.     Special permission hereby goes to Fred Fish's AmigaLib-Disks and
  39.     the german series (in alphabetical order) :
  40.     AmigaSzene, BerndsPD, FRANZ, GPD, TAIFUN and TIME.
  41.  
  42.     This program may also be distributed via electronic mail and may be
  43.     put into mailboxes as long as the redistribution conditions are
  44.     respected in all points. Special permission hereby goes to Aminet.
  45.  
  46.     By using or distributing this program you automatically agree to
  47.     all of the above conditions and terms.
  48.  
  49.  
  50.     Function/Usage :
  51.     ================
  52.     "DeTar" extracts Unix Tar-Archives and may - not very well -
  53.     also list their contents.
  54.  
  55.     Extracting :       DeTar [Archive-Name]
  56.     Listing    :       DeTar d [Archive-Name]
  57.  
  58.     Often Tar-Files have been "zipped" with GZip, after that changing
  59.     their extension to ".tgz".
  60.     Just extract the original Archive with "GZip" and then use "DeTar"
  61.     on them.
  62.  
  63.  
  64.     Additional Information / Credits :
  65.     ==================================
  66.  
  67.     [ History ]
  68.  
  69.     Did you ever tried to extract a simple Unix TAR-Archive ?
  70.  
  71.     Some time ago I bough a "Source-Code" CD-ROM (Walnut Creek), which
  72.     mainly contained ".zip", ".tgz" and ".tar" Files, but nearly no
  73.     unarchived Source-Codes.
  74.     It was quite easy to find programs to extract the ".zip" (UnZip)
  75.     and ".tgz" (GZip) Archives, but what about the ".tar" Archives ?
  76.     Additionally, the ".tgz" Files also contain Tar-Archives !
  77.  
  78.     Due to the fact, that I couldn't find any Tar-Archiver anywhere
  79.     (Fish-Disks, SaarAG-Disks, ...), I decided to port one from
  80.     Unix, MS-DOS, or whatever.
  81.     So I tried to find a Tar-Archive-Source for any of these Systems
  82.     on the CD-ROM.
  83.     Most of the Tar-Archivers there were either only MS-DOS executables
  84.     without any Source-Code, or they had been archived with Tar themselves !
  85.     After searching some time, I found the "PDTAR" source code for Unix,
  86.     but I was very hard to port it, because of the missing User/Group
  87.     functions under AmigaDOS and other Unix standard functions.
  88.     So I took the Source of "detar" for MS-DOS, which is public domain
  89.     and also based on the original "GNU tar".
  90.     I removed the MS-DOS specific functions and created an Amiga Version,
  91.     which is still thought to do only the _main_ thing :
  92.     extracting tar-files to disk-based mediums !
  93.     The original SourceCode is as well included as the Amiga-Source !
  94.  
  95.     "detar" for MS-DOS has been written in 1988 by Steve R. Sampson
  96.     and bases on the originally public domain TAR program by John Gilmore.
  97.     The original documentation of "detar" has been appended to this
  98.     doc-file.
  99.  
  100.  
  101.     Correspondence :
  102.     ================
  103.     Send bug-reports, money or whatever to :
  104.  
  105.        EMail: Andreas_Kleinert@t-online.de
  106.        Fido:  2:2457/350.18
  107.  
  108.        (The Original Author of the Amiga Version, i just recompiled it for
  109.        WarpOS)
  110.  
  111.     History :
  112.     =========
  113.  
  114.      V1.5 (18.2.1998
  115.      ------
  116.      - recompiled with StormC PPC
  117.  
  118.      V1.3 (27.10.1997):
  119.      ------
  120.       - recompiled with SAS/C 6.58
  121.  
  122.      V1.2 (28.3.1995):
  123.      -----------------
  124.       - replaced time conversion functions with SAS/C pendants
  125.       - using GlobalSymbolTable now, thus some self-made definitons
  126.         could be removed
  127.       - clearified code by replacing some ints with longs
  128.       - re-packed MS-DOS stuff with LHA
  129.       - added 68030 version
  130.       - and more
  131.  
  132.      V1.1 (24.4.1994):
  133.      -----------------
  134.       - first version. Public Domain.
  135.  
  136.  
  137.     Copyrights :
  138.     ============
  139.     Some of the mentioned names or products above may be copyrighted by
  140.     companies or trademarks of companies.
  141.  
  142.  
  143.  ***************************************************************************
  144.  
  145.     Original Documentation follows
  146.  
  147.  ***************************************************************************
  148.  
  149.                               Detar Documentation
  150.  
  151.                                 23 January 1988
  152.  
  153.    The Unix(tm) Forum has decided to archive its uploads in the compressed
  154. TAR format.  The 'detar' program is meant to provide you with a method of
  155. bursting the files on an MS-DOS(tm) computer.  Additionally the source code
  156. in 'C' is included so others can use it as a base for porting to other
  157. computers.  As a disclaimer: not a lot of planning went into the program.
  158. I basically rounded up some code laying around and threw it together.
  159.  
  160.    In order to make the program useful to MS-DOS computers some features
  161. of TAR format had to be worked around.  For instance: filenames.  The solution
  162. was simple, reduce to 3 characters after the first dot '.'.  Reduce to eight
  163. characters before the dot.  Multiple dots are changed to dash '-' after the
  164. first dot is found.  (Run this program on smail.tar for a good example).
  165.  
  166. The directory 'd' option shows all the filenames in their original state.
  167.  
  168.    The 'detar' program has exactly two options.  One is to perform a direct-
  169. ory, and the second is to extract files.  There is no TAR create routines.
  170. The directory output can be redirected to a file or a printer.  The best
  171. method of using the extraction option is as follows:
  172.  
  173.         1.      Put the detar.exe file in the \bin directory.  Set your path
  174.                 command to search the \bin.
  175.  
  176.         2.      Create a working directory, such as:  'MD TMP'.
  177.  
  178.         3.      Change to the temporary directory:  'CD TMP'.
  179.  
  180.         4.      Execute detar:  'detar ../smail.tar'
  181.  
  182.                 This will begin building files in the TMP directory based
  183.                 on the naming algorithm above.  This is the simplest method
  184.                 and you will determine your best procedure after working with
  185.                 the program for awhile.
  186.  
  187.    A sample of the output received when executing the 'directory' option:
  188.  
  189.         C>detar d ../smail
  190.  
  191.         -rw-r--r-- 102/10  1006 Aug 27 21:42 1987 src/Makefile
  192.         -rw-r--r-- 102/10  9875 Aug 27 21:42 1987 src/alias.c
  193.         -rw-r--r-- 102/10  9983 Aug 27 21:43 1987 src/defs.h
  194.         -rw-r--r-- 102/10 10007 Aug 28 14:39 1987 src/defs.h.kk
  195.         -rw-r--r-- 102/10 12008 Aug 27 21:42 1987 src/deliver.c
  196.         -rw-r--r-- 102/10  2533 Aug 27 21:42 1987 src/getopt.c
  197.         -rw-r--r-- 102/10  2218 Aug 27 21:42 1987 src/getpath.c
  198.  
  199.         ...
  200.  
  201. The first column is the protection bits.  It is Unix specific.  As is
  202. the next column which is the user and group number of the person who made
  203. the archive.  Absolutely no use at all in MSDOS.  The third column is the file
  204. size in bytes.  The fourth column is the date, and the fifth is the complete
  205. filename.
  206.  
  207.    If you make a mistake on the detar command line, three error messages are
  208. output:
  209.  
  210.         C>detar g ..\smail
  211.  
  212. 1.      Usage: detar [d] filename[.tar]
  213.         Where d means directory only
  214.  
  215.         C>detar ..\smale
  216.  
  217. 2.      Tar File '..\SMALE.TAR' Not Found
  218.  
  219.         C>detar ..\detar.c
  220.  
  221. 3.      File '..\DETAR.C' not a TAR archive
  222.  
  223. The brackets ('[', ']') shown on the "Usage" line mean that the information
  224. contained within them are optional.
  225.  
  226.    A sample output from the extraction option follows:
  227.  
  228.         C>detar smail
  229.         Extracting: Makef